为应用程序制定主题

主题可让一个 Kanzi Studio 工程用于多个产品车型。例如，在单个工程中，您可以为不同的汽车模型和每个汽车模型的不同可视主题定义 Kanzi 应用程序。

为应用程序创建主题涉及不同资源的创建和使用，例如您要在应用程序中使用的主题文本、纹理、笔刷、材质和样式、布局等。

主题组 (Theme Group)定义主题 (Theme) 的集合。主题组 (Theme Group) 中的每个主题 (Theme) 定义应用程序的外观和感觉。在您的 Kanzi Studio 工程中，您可以定义多个主题组 (Theme Group)，其中每个包含多个主题 (Theme)。在 Kanzi 应用程序中，您可以一次从各 主题组 (Theme Group) 应用一个主题 (Theme)。例如，您可以使用一个主题组 (Theme Group) 定义汽车模型，如两厢车、面包车，皮卡，轿车和 SUV，另一个主题组 (Theme Group) 定义各汽车模型的界面外观，如经典、数字、现代和运动。

Kanzi 通过含各主题 (Theme) 单独值的资源 ID 间接使用已制定主题的资源。在素材库 (Library) > 主题 (Theme) 中，您可以看到 Kanzi Studio 工程中的所有主题组 (Theme Group) 项。

要为您的应用程序创建主题：

1. 创建主题组 (Theme Group)，并将其添加到要通过主题 (Theme) 定义的工程资源中。请参阅将工程中使用的资源添加到主题组 (Theme Group)。
2. 创建并导入每个主题 (Theme) 使用的资源。请参阅为主题 (Theme) 设置资源。
3. 在预览 (Preview) 中查看主题 (Theme)。请参阅在预览 (Preview) 中查看主题。
4. 将主题 (Theme) 使用的资源导出到 kzb 文件。请参阅导出主题 (Theme)。

完成教程，了解如何为您的Kanzi 应用程序制定主题。请参阅教程：为应用程序制定主题。

将工程中使用的资源添加到主题组 (Theme Group)

向主题组 (Theme Group) 添加要制定主题的资源，开始为您的 Kanzi 应用程序创建主题。向主题组 (Theme Group) 添加资源的最快方式是使用 工程 (Project) 中节点上的添加资源至主题组 (Add Resources to a Theme Group) 指令。

当您使用工程 (Project) 中的添加资源至主题组 (Add Resources to a Theme Group) 指令，Kanzi Studio 为该节点及其树中的各节点的每个资源自动创建资源 ID，并将每个节点设置为使用这些资源 ID。

要将工程中使用的资源添加到 主题组 (Theme Group)：

1. 在工程 (Project) 中，右键点击屏幕 (Screen) 节点，并在上下文菜单中选择添加资源至主题组 (Add Resources to a Theme Group)。
   当在屏幕 (Screen) 节点上使用添加资源至主题组 (Add Resources to a Theme Group) 命令时，您可以使用 Kanzi Studio 将工程中的所有资源添加到主题组 (Theme Group) 并更改其在各主题 (Theme) 中的外观。要只将所选节点或预设件及其节点树的资源添加到 主题组 (Theme Group)，右键点击节点或预计件并选择 添加资源至主题组 (Add Resources to a Theme Group)。
   
2. 在添加资源至主题组 (Add Resources to a Theme Group) 窗口中设置：
   1. 主题组 (Theme Group) 设为要添加资源的主题组 (Theme Group)。如果您没有 主题组 (Theme Group)，选择 <Create New>。
      主题组 (Theme Group)定义主题 (Theme) 的集合。
   2. 选择要在添加资源至主题组 (Add Resources to a Theme Group) 窗口中显示的资源类型。
      例如，要只显示文本和图像资源，请选择 和 。
      
   3. 在列出选定类型所有资源的列表中，点击要添加到选定主题组 (Theme Group) 的资源旁边的复选框。要更改资源 ID，请右键点击资源 ID 并输入一个新名称。
      Kanzi Studio 会为对文本 (Text) 属性使用同一个值的多个文本块 (Text Block) 节点创建一个单个的资源 ID。这些节点共享主题组 (Theme Group) 中的相同条目。
   4. 点击添加 (Add)。
      Kanzi Studio 从所有资源创建资源 Id，并将其添加到选定的主题组 (Theme Group)。您可以在素材库 (Library) > 主题 (Theme) 中找到主题组 (Theme Group) 项。在主题组 (Theme Group) 中，您现在可以创建主题 (Theme) 并设置要为主题 (Theme) 使用的资源。请参阅为主题 (Theme) 设置资源。
      

为主题 (Theme) 设置资源

在向主题组 (Theme Group) 添加工程中使用的资源后，您可以创建主题 (Theme) 并定义各主题 (Theme) 使用的资源。

要为主题 (Theme) 设置资源：

1. 创建并导入各主题 (Theme) 使用的资源。例如：
   • 在素材库 (Library) 中创建资源，如设置您的应用程序中各主题外观的笔刷、样式和材质。
   • 在预设件 (Prefabs) 中创建排列您的应用程序中各主题 UI 元素的布局。
   • 在资产 (Assets) 中导入要在主题 (Theme) 中使用的 2D 和 3D 资产。
2. 在素材库 (Library) > 主题 (Theme) 中双击您要在其中定义主题 (Theme) 的主题组 (Theme Group)。
3. 在主题编辑器 (Theme Editor) 中点击创建主题 (Create Theme) 并命名主题 (Theme)。
   
4. 在上一步中创建的主题栏中，双击各资源单元格，为该行资源 ID 设置要使用的资源。
   • 如果您没有为主题 (Theme) 选择资源或值，Kanzi 会使用主题 (Theme) 的默认资源或值。默认值列在默认值 (Default Value) 列中。
     黑色单元格标记使用默认值的条目。
   • 要为文本资源使用空字符串，输入值，删除值，然后按下 Enter 键。
     灰色单元格标记使用空字符串的条目。
   • 要使用文件系统的资源，在要设置资源的单元格中选择 < URL >，并输入 file://，后跟该文件系统资源的绝对或相对路径。
   

为 主题 (Theme) 中的资源使用 kzb 文件 URL

在将您工程中使用的资源添加到 主题组 (Theme Group) 中以后，您可以使用 kzb 文件 URL 指向另一个 Kanzi Studio 工程中的资源。

要为 主题 (Theme) 中的资源使用 kzb 文件 URL：

1. 在素材库 (Library) > 主题 (Theme) 中双击您要在其中定义主题 (Theme) 的主题组 (Theme Group)。
2. 在主题编辑器 (Theme Editor) 中点击创建主题 (Create Theme) 并命名主题 (Theme)。
   
3. 在上一步中创建的主题 (Theme) 栏中，双击要使用 kzb 文件 URL 的资源单元格，并在下拉菜单中选择 < URL >。
   
4. 在单元格中，输入要使用的资源的 kzb 文件 URL。
   例如，要使用来自另一个 Kanzi Studio 工程的字体，请输入指向字体的 kzb 文件 URL。
   

在预览 (Preview) 中查看主题

在为您的应用程序定义主题 (Theme) 时，可以将预览 (Preview) 设置为显示主题 (Theme)，无需向应用程序添加切换主题 (Theme) 的控件。

要在预览 (Preview) 中查看主题 (Theme)：

• 在字典 (Dictionaries) 中点击地区和主题 (Locales and Themes) 以启用查看 本地化表 (Localization Table) 和主题组 (Theme Group) 项，并为每个主题组 (Theme Group) 选择要在预览 (Preview) 中查看的主题 (Theme)。
  
• 在素材库 (Library) 中选择包含要查看的主题 (Theme) 的主题组 (Theme Group)，并在属性 (Properties) 中将选定主题 (Selected Theme) 属性设置为主题 (Theme)。
  

另请参阅

教程：为应用程序制定主题

导出主题 (Theme)

使用主题 (Theme)

打开导航